home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 42 / Amiga Format AFCD42 (Issue 126, Aug 1999).iso / -serious- / graphics / mpsql15 / readme < prev    next >
Text File  |  1999-05-25  |  4KB  |  140 lines
  1. MPSQL - An Interactive Query Tool for PostgresSQL 
  2.  
  3. This directory contains version 1.5 of MPSQL.
  4.  
  5. The author can be reached via Email: keidav@whidbey.com
  6.  
  7. or visit http://www.troubador.com/~keidav/index.html
  8.  
  9. MPSQL is not public domain software.  It is copyrighted by White
  10. River Software but may be used according to the licensing
  11. terms of the the copyright at the end of this document.
  12.  
  13. HISTORY:
  14.  
  15. MPSQL was born out of the need for a usable query tool to help me with
  16. working with PostgresSQL while prototyping a database backed WWW application.
  17.  
  18. You will have excuse some of the bad coding practices in this release, while 
  19. trying to write a real app and a tool at the same time something gives ;) 
  20. if any interest in this comes up I will clean things up.  So if you do find 
  21. this useful, please drop me a mail message with your comments! (mail address above)
  22.  
  23. I have only tested this under Linux and Solaris 2.5, but it is generic enough it 
  24. should compile under other UNIX systems as well.
  25.  
  26. FEATURES:
  27.  
  28. * execute multiple SQL statements or one of many by highlighting then executing
  29. * work with multiple buffers
  30. * open/save buffers from/to files
  31. * cut/copy/paste between buffers
  32. * spool query output to a file
  33. * spool data in fixed length, comma, tab or space delimited format
  34. * print buffers
  35. * save application options to a startup file ($HOME/.mpsql)
  36.  
  37. REQUIREMENTS:
  38.  
  39. PostgresSQL 6.0 - libpq
  40. Motif 2.0 - a statically linked binary is available!
  41. libc.so.5+
  42. libdl.so.1.7+
  43. libXxxx.so.6
  44. libXpm.so.4.3
  45.  
  46. INSTALLING:
  47.  
  48. The following should work on most systems:
  49.  
  50. Check the Imakefile and make any required changes. Then,
  51.  
  52. xmkmf
  53. make
  54. make install
  55.  
  56. If this doesn't work the try editing Makefile.std
  57. and modify the include and lib paths as needed and ...
  58.  
  59. make -f Makefile.std
  60. cp mpsql /usr/bin (or whatever...)
  61. cp Mpsql.ad /usr/X11/lib/X11/app-defaults/Mpsql
  62.  
  63. RUNNING:
  64.  
  65. After installing, start the app (mpsql) and select the "Connect to DB" 
  66. option from the "File" menu or the "Connect" button on the tool 
  67. bar to logon, an error dialog will come up if unsuccessful or the 
  68. status bar will verify a successful connection with the name of 
  69. the database.
  70.  
  71. BUGS:
  72.  
  73. I am sure you will find some undocumented "features" ;) and if you do
  74. please fill out the bug.template and mail it to me. Thank-you!!
  75.  
  76. --v.0.9.1
  77.  
  78.     first beta release
  79.  
  80. --v.0.9.2
  81.  
  82.     implemented a more elegent solution to String redef problems with
  83.     <libpq-fe.h> and <X11/Intrinsic.h> , what was I thinking of before %) 
  84.     thanks to Ronald Wahl <Ronald.Wahl@Informatik.TU-Chemnitz.DE> for 
  85.     pointing out the obvious. 
  86.  
  87. --v.1.0.0
  88.     
  89.     command line arguments now supported for: host, port, database and help.
  90.     
  91.     user is now prompted with a file 'Save As' dialog when selecting 'Save'
  92.     for 'Scratch' buffers.
  93.  
  94.     application now grabs keys & buttons while processing a query & displays
  95.     watch cursor while processing query.
  96.  
  97.     support has been added for the postgres 'Copy' commands.
  98.  
  99.     fixed memory leak that occurred when calling DB_Connect().
  100.  
  101.     buffer list is now available as a pulldown menu.
  102.  
  103. --v.1.5.0
  104.     
  105.     basically done to verfiy code works with PostgresSQL v.6.0.
  106.  
  107.     added tooltips.
  108.  
  109.     stderr redirected so EXPLAIN results are shown in application.
  110.  
  111.     Imakefile added.
  112.     
  113.     optional highcolor pixmaps (afterstep-ish appearence).    
  114.  
  115.     application icon should now display properly under different WM's.
  116.  
  117.  
  118. TODO:
  119.  
  120. I am considering merging the createdb, createuser, and dump apps into this
  121. application as well.  I will be adding a loader utility similar to Sybase's and
  122. Oracle's loader utilities in the near future.
  123.  
  124. Permission to use, copy, modify, and distribute this software and its
  125. documentation for any purpose, without fee, and without a written agreement
  126. is hereby granted, provided that the above copyright notice and this
  127. paragraph and the following two paragraphs appear in all copies.
  128.  
  129. IN NO EVENT SHALL WHITE RIVER SOFTWARE BE LIABLE TO ANY PARTY FOR
  130. DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING
  131. LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS
  132. DOCUMENTATION, EVEN IF WHITE RIVER SOFTWARE HAS BEEN ADVISED OF THE
  133. POSSIBILITY OF SUCH DAMAGE.
  134.  
  135. WHITE RIVER SOFTWARE SPECIFICALLY DISCLAIMS ANY WARRANTIES,
  136. INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
  137. AND FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
  138. ON AN "AS IS" BASIS, AND WHITE RIVER SOFTWARE HAS NO OBLIGATIONS TO
  139. PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS. 
  140.